/**
 * 版权所有(C)，上海海鼎信息工程股份有限公司，2008，所有权利保留。
 * 
 * 项目名：	rumba
 * 文件名：	CartridgeService.java
 * 模块说明：	
 * 修改历史：
 * Feb 20, 2008 - lxm - 创建。
 */
package com.hd123.rumba.gwt.cartridge.client;

import java.util.List;

import com.google.gwt.core.client.GWT;
import com.google.gwt.user.client.rpc.ServiceDefTarget;
import com.hd123.rumba.gwt.base.client.RBRemoteService;
import com.hd123.rumba.gwt.base.client.exception.ClientBizException;
import com.hd123.rumba.gwt.cartridge.client.biz.QCartridge;

/**
 * 构件包 | 远程服务 | 接口类
 * 
 * @author lxm
 * 
 */
public interface CartridgeService extends RBRemoteService {
  
  public static class Locator {
    
    private static CartridgeServiceAsync service = null;
    private static final String SERVICE_URL = "RB/cartridge";
    
    public static CartridgeServiceAsync getService() {
      if (service == null) {
        service = (CartridgeServiceAsync) GWT.create(CartridgeService.class);
        ServiceDefTarget endpoint = (ServiceDefTarget) service;
        String moduleRelaUrl = GWT.getModuleBaseURL() + SERVICE_URL;
        endpoint.setServiceEntryPoint(moduleRelaUrl);
      }
      return service;
    }
  }

  /**
   * 取得当前作为封面的构件包信息。
   * 
   * @return
   * @throws ClientBizException
   */
  public QCartridge getCoverCartridge() throws ClientBizException;

  /**
   * 取得所有已安装的构件包信息。
   * 
   * @return
   * @throws ClientBizException
   * @gwt.typeArgs <com.hd123.rumba.gwt.cartridge.client.biz.QCartridge>
   */
  public List getAllCartridges() throws ClientBizException;
}
